KCUpdateItem

KCUpdateItem
Header:	Keychain.h		Carbon status:	Under Evaluation

Updates a password or other keychain item.

OSStatus KCUpdateItem (
    KCItemRef item
);

Parameter descriptions

item: A reference to the keychain item whose data you wish to update. If you pass an item that has not been previously added to the keychain, KCUpdateItem does nothing and returns noErr.

function result: A result code. The result code errKCNoDefaultKeychain indicates that no default keychain could be found. The result code errKCInvalidItemRef indicates that the specified keychain item reference was invalid.

DISCUSSION

You can use the KCUpdateItem function to update a password or other keychain item in a keychain’s permanent data store after changing its data. KCUpdateItem will automatically call the function KCUnlock to display the Unlock Keychain dialog box if the keychain containing the item is currently locked.

VERSION NOTES

Available beginning with Keychain Manager 1.0.